Add docs for the parent-set signal. (#353772, Mariano Suárez-Alvarez)

2006-09-09  Matthias Clasen <mclasen@redhat.com>

        * gtk/gtkwidget.c: Add docs for the parent-set signal.
        (#353772, Mariano Suárez-Alvarez)

diff --git a/ChangeLog b/ChangeLog
index 12f042d86753a72ca1b5b1e3cf4c6c81e7d9a574..d5878eea5547b7d6c20c41976f6436be2708e62c 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,9 @@
+2006-09-09  Matthias Clasen <mclasen@redhat.com>
+
+       * gtk/gtkwidget.c: Add docs for the parent-set signal.
+       (#353772, Mariano Suárez-Alvarez)
+
+
 2006-09-08  Matthias Clasen <mclasen@redhat.com>
 
        * gtk/gtktextbuffer.c (remove_all_selection_clipboards):

diff --git a/gtk/gtkwidget.c b/gtk/gtkwidget.c
index cf96bc4c36f6df208003273ddb09526732dd5ac4..a5fadf9b82c40971c7a60310a5ab2842d1eca000 100644 (file)
--- a/gtk/gtkwidget.c
+++ b/gtk/gtkwidget.c
@@ -620,6 +620,16 @@ gtk_widget_class_init (GtkWidgetClass *klass)
                  _gtk_marshal_VOID__ENUM,
                  G_TYPE_NONE, 1,
                  GTK_TYPE_STATE_TYPE);
+
+  /**
+   * GtkWidget::parent-set:
+   * @widget: the object on which the signal is emitted
+   * @old_parent: the previous parent, or %NULL if the widget 
+   *   just got its initial parent.
+   *
+   * The parent-set signal is emitted when a new parent has been set 
+   * on a widget. 
+   */
   widget_signals[PARENT_SET] =
     g_signal_new (I_("parent_set"),
                  G_TYPE_FROM_CLASS (gobject_class),